home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 7 / Apprentice-Release7.iso / Source Code / C / Applications / MacGzip 1.1.1 / Docs / README (mac sources) < prev   
Encoding:
Text File  |  1997-07-20  |  5.1 KB  |  130 lines  |  [TEXT/ttxt]

  1. •  MacGzip 1.1.1 (gzip 1.2.4) -sources-
  2.  
  3. You can build MacGzip 1.1 using:
  4.  
  5.  Symantec C 8.0
  6.  MW CW 11 IDE 1.7.4
  7.     Note: if you are interested in comipiling the PPC version with Symantec 8.0, drop me a note. (mailto:macspd@ivo.cps.unizar.es)
  8.  
  9. •  About the sources....
  10.  
  11. MacGzip was developed mainly from two sources: gzip 1.2.4 original distribution (by Jean-loup Gailly) and the example source code from Apple's  Developer CD Series. I must mention also Quinn <quinn@cs.uwa.edu.au> (et al) for Internet Config Prog Kit., and Erling Johansen <ejo@vingmed.no>, who made the first PPC porting (0.3b3, b3 and b5)
  12.  
  13. (In MacGzip's readme, you can find a list of involuntary contributions, and also in the source code)
  14.  
  15. Part of the Apple source code comes from Snippets
  16. (Snippets are not tested by anyone, except (presumably) the author. They are NOT to be considered the final or best way to do something. They are just bits of code that the DTS engineers and others come up with and feel might be useful to developers. Think of Snippets as a "Bucket 'o Rusty Parts" that is provided for your browsing pleasure, NOT as polished examples. A Snippet should only be used in a commercial application if YOU are sure that it does what you want. )
  17. so, you can apply this to macgzip sources, too.
  18.  
  19. In earlier versions (specially the ones previous to 0.3), the mac code (and gzip.c) was really bad in some points. I think this time it is better,  but if you want to use somethig as example, check it carefully).
  20.  
  21. In 1.0b0 there are a bunch of stupid (but serious) bugs, I think they all are fixed in this release (who knows?)
  22.  
  23. • The sources
  24.  
  25. 'GNU' folder contains GNU sources and documentation, several files had been modified. If you find some error here, probably is mine.
  26.  
  27. In this release (1.x) gzip sources were modified in the right way (using the correct #ifdefs, this wasn't true for previous versions), so you can compile the sources in the same machines as original gzip 1.2.4 sources.(I hope)
  28. (choosing the original gzip.c, which I renamed to gzip.c.cln)
  29.  
  30. "#define MACOS" options are generic for every Mac OS (I guess), for MacGzip only options I use "#define MACGZIP" (in the first lines of 'tailor.h').
  31. Note: #define MAXSEG_64K is required by unlzw.c in order to decompress Unix .Z files.
  32.  
  33. Note: In Symantec C, you can't compile gzip using 4 bytes integers; some ANSI functions are implemented in 68K .asm format, and they expect 2 bytes ints.
  34.  
  35. Changes:
  36.  
  37.     -Standard output and error by alerts.
  38.     -Insert here an there System Tasks to be nice with other applications and to update progress bar. (for example one call in the 'fill the input buffer' function)
  39.     -other... (Search MACGZIP || MACOS || spd)
  40.  
  41. Note: Some of the command line options (-vlt) are not available just because they require aditional Macintosh interface; but using Think C console (and the original gzip.c.cln with some little modifications), they should work.
  42.  
  43.  
  44. 'Mac' folder holds some files from Internet Config Programmers Kit, and the sources of the interface; they can be reused with some minor changes for any other file processing (input file + few parameters -> output file).
  45.  
  46. There are several ways in which this source could be improved; here you are some:
  47.  
  48. -MacAE.c:
  49.     High Level Events with aditional parameters
  50.  
  51. -GzErrors.c:
  52.           Draw a color 'rotate' icon (instead of a 'SICN')
  53.  
  54. -Work.c:
  55.     There must be a better way to do this...
  56.  
  57. -PrefsDlg.c:
  58.           Make dialog not modal
  59.  
  60. -MacIO.c: 
  61.           Is a generic library to do transparent IO in ascii/bin/macbinary mode. It has some limitations: It doesn't support O_APPEND, etc...; and the macbinary code does not saves/restores finder comments (I hate Finder Comments, anyway)
  62.  
  63.  
  64. Generic:
  65.         Change all literal strings to resources (very boring work; too many #ifdefs for GNU sources.)
  66.   Use the thread manager instead of such confusing event loop.(?)
  67.  
  68.  
  69. • The Song
  70.  
  71.  
  72.         Pide, pídeme la vida
  73.         Pide, pidela una vez
  74.         Mira, mirame despacio
  75.         Deja, déjame caer
  76.         
  77.         Si
  78.             tu noche está vacía,
  79.         pon
  80.             un crimen en tu vida
  81.         Si
  82.             tu copa está vacia,
  83.         pon
  84.             un crimen en tu vida
  85.         
  86.         Pisa, písame la sombra
  87.         Sigue, sígueme hasta ver
  88.         Muerto, matame estoy muerto
  89.         Muerto, me dejo querer
  90.         
  91.         Si
  92.             tu noche está vacía,
  93.         pon
  94.             un crimen en tu vida
  95.         Si
  96.             tu copa está vacia,
  97.         pon
  98.             un crimen en tu vida
  99.  
  100.         Fuera , fuera de peligro
  101.         Dentro, Dentro de la ley
  102.         Muerto, Muerto estoy despierto
  103.         Muerto, soñaré al revés
  104.  
  105.         Si
  106.             tu noche está vacía,
  107.         pon
  108.             un crimen en tu vida
  109.         Si
  110.             tu copa está vacia,
  111.         pon
  112.             un crimen en tu vida
  113.         
  114.         Si tu noche está vacía,
  115.         te dare tu medicina
  116.         Si tu copa está vacía,
  117.         te daré tu medicina
  118.         
  119.         Si tu noche 
  120.         Si tu copa
  121.         Si tu copa
  122.         Si tu noche
  123.         
  124.         Si tu vida es una ruina,
  125.         te daré tu medicina
  126.         Si tu vida es una ruina,
  127.         te daré tu medicina
  128.  
  129.                         Juan Pablo Silvestre (La Boa)
  130.